package cn.highedu.coolshark.product.mapper;

import cn.highedu.coolshark.product.pojo.dto.BrandQueryParamDTO;
import cn.highedu.coolshark.product.pojo.entity.Brand;
import cn.highedu.coolshark.product.pojo.vo.BrandListItemVO;
import cn.highedu.coolshark.product.pojo.vo.BrandStandardVO;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Repository;

import java.util.List;

/**
 * 处理品牌数据的Mapper接口
 */
@Repository
public interface BrandMapper {
    /**
     * 查询品牌数据列表
     * @return 品牌数据列表
     */
    List<BrandListItemVO> list();

    /**
     * 根据品牌名称查询品牌数据列表 分页查询
     * @param brandQueryParamDTO 封装了查询条件的对象
     * @return 品牌数据列表
     */
    List<BrandListItemVO> listByParam(BrandQueryParamDTO brandQueryParamDTO);

    /**
     * 根据品牌名称查询品牌数据列表数据的数量(总条数)
     * @param brandQueryParamDTO 封装了查询条件的对象
     * @return 品牌数据列表数据的数量
     */
    Integer countByParam(BrandQueryParamDTO brandQueryParamDTO);

    /**
     * 更新品牌数据
     * @param brand 封装了品牌的id和需要更新的数据对象
     * @return 受影响的行数
     */
    int update(Brand brand);

    /**
     * 根据id删除品牌数据
     * @param id 品牌id
     * @return 受影响的行数
     */
    int deleteById(Long id);

    /**
     * 插入品牌数据
     * @param brand 品牌数据
     * @return 受影响的行数
     */
    int insert(Brand brand);

    /**
     * 根据品牌名统计数据的数量
     * @param name 品牌名称
     * @return 匹配名称的品牌数据的数量
     */
    int countByName(String name);

    /**
     *
     * @param id 当前品牌id
     * @param name 品牌名
     * @return 当前表中除了该品牌id以外的品牌名相同的数据数量
     * 注解@Param 用于在执行SQL语句的时候传递多个参数 指明参数对应SQL语句中占位符
     */
    int countByNameAndNotId(@Param("id") Long id, @Param("name") String name);

    /**
     * 根据ID查询品牌数据详情
     * @param id 品牌ID
     * @return 匹配的品牌数据详情, 如果没有匹配的数据, 返回null
     */
    BrandStandardVO getStandardById(Long id);

    /**
     * 根据类别id查询与类别关联的品牌列表
     * @param categoryId 类别id
     * @return 关联的品牌列表
     */
    List<BrandListItemVO> listByCategory(Long categoryId);
}
